home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cato / Xm / MrmFetchSetValues.z / MrmFetchSetValues
Encoding:
Text File  |  1998-10-20  |  7.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss - Fetches the values to be set from
  10.           literals stored in UID files
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<MMMMrrrrmmmm////MMMMrrrrmmmmPPPPuuuubbbblllliiiicccc....hhhh>>>>
  14.  
  15.           CCCCaaaarrrrddddiiiinnnnaaaallll MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((_h_i_e_r_a_r_c_h_y__i_d, _w_i_d_g_e_t, _a_r_g_s, _n_u_m__a_r_g_s))))
  16.                MMMMrrrrmmmmHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy_h_i_e_r_a_r_c_h_y__i_d;;;;
  17.                WWWWiiiiddddggggeeeetttt    _w_i_d_g_e_t;;;;
  18.                AAAArrrrggggLLLLiiiisssstttt   _a_r_g_s;;;;
  19.                CCCCaaaarrrrddddiiiinnnnaaaallll  _n_u_m__a_r_g_s;;;;
  20.  
  21.  
  22.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  23.           This page documents version 1.2 of the Motif library.
  24.  
  25.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.           The MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss function is similar to XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss,
  27.           except that the values to be set are defined by the UIL
  28.           named values that are stored in the UID hierarchy.
  29.           MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss fetches the values to be set from literals
  30.           stored in UID files.
  31.  
  32.  
  33.           _h_i_e_r_a_r_c_h_y__i_dSpecifies the ID of the UID hierarchy that
  34.                       contains the specified literal. The _h_i_e_r_a_r_c_h_y__i_d
  35.                       was returned in a previous call to
  36.                       MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy.
  37.  
  38.           _w_i_d_g_e_t      Specifies the widget that is modified.
  39.  
  40.           _a_r_g_s        Specifies an argument list that identifies the
  41.                       widget arguments to be modified as well as the
  42.                       index (UIL name) of the literal that defines the
  43.                       value for that argument.  The name part of each
  44.                       argument (args[n].name) must begin with the
  45.                       string XXXXmmmmNNNN followed by the name that uniquely
  46.                       identifies this attribute tag.  For example,
  47.                       XXXXmmmmNNNNwwwwiiiiddddtttthhhh is the attribute name associated with
  48.                       the core argument _w_i_d_t_h.  The value part
  49.                       (args[n].value) must be a string that gives the
  50.                       index (UIL name) of the literal.  You must
  51.                       define all literals in UIL as exported values.
  52.  
  53.           _n_u_m__a_r_g_s    Specifies the number of entries in _a_r_g_s.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           This function sets the values on a widget, evaluating the
  75.           values as public literal resource references resolvable from
  76.           a UID hierarchy.  Each literal is fetched from the
  77.           hierarchy, and its value is modified and converted as
  78.           required.  This value is then placed in the argument list
  79.           and used as the actual value for an XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss call.
  80.           MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss allows a widget to be modified after
  81.           creation using UID file values exactly as is done for
  82.           creation values in MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt.
  83.  
  84.           As in MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt, each argument whose value can be
  85.           evaluated from the UID hierarchy is set in the widget.
  86.           Values that are not found or values in which conversion
  87.           errors occur are not modified.
  88.  
  89.           Each entry in the argument list identifies an argument to be
  90.           modified in the widget.  The name part identifies the tag,
  91.           which begins with XXXXmmmmNNNN.  The value part must be a string
  92.           whose value is the index of the literal.  Thus, the
  93.           following code would modify the label resource of the widget
  94.           to have the value of the literal accessed by the index
  95.           OK_button_label in the hierarchy:
  96.  
  97.           args[n].name = XmNlabel;
  98.           args[n].value = "OK_button_label";
  99.  
  100.  
  101.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  102.           This function returns one of these status return constants:
  103.  
  104.  
  105.           MMMMrrrrmmmmSSSSUUUUCCCCCCCCEEEESSSSSSSS     The function executed successfully.
  106.  
  107.           MMMMrrrrmmmmPPPPAAAARRRRTTTTIIIIAAAALLLL____SSSSUUUUCCCCCCCCEEEESSSSSSSS
  108.                          At least one literal was successfully
  109.                          fetched.
  110.  
  111.           MMMMrrrrmmmmBBBBAAAADDDD____HHHHIIIIEEEERRRRAAAARRRRCCCCHHHHYYYY
  112.                          The hierarchy ID was invalid.
  113.  
  114.           MMMMrrrrmmmmFFFFAAAAIIIILLLLUUUURRRREEEE     The function failed.
  115.  
  116.  
  117.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  118.           MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy((((3333XXXX)))), XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX)))).
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.